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Copyright (c3 1383. All rights reserved. This SUPER LIST 
BASIC cowputer prograw and/or documentation may not in part, 
or in whole, be copied in any form without the prior written 
consent of Mandala media. 


I> JIlSOLCliXMEf;!: 


Mandala Media assumes no liability or responsibility to the 
purchaser or any other entity or person with respect to any 
damage or loss, or alleged damage or loss caused directly or 
indirectly by the use of the SUPER LIST BASIC computer 
program. This disclaimer includes but is not limited to any 
loss of business, any loss of anticipated profits, any 
interruption in business or any other damages resulting from 
or allegedly resulting from the use of SUPER LIST BASIC. If 
your state does not allow any of the statements or 
representations contained in this disclaimer, then those 
shall not apply to you. You may also have other rights which 
depend upon your state of residence. 


Defective media will be replaced; however, in no case will 
Mandala Media be responsible for more than the original 
purchase price of the SUPER LIST BASIC computer program. 


The use of SUPER LIST BASIC is at the users discretion and 
risk. Neither the Author nor Mandala Media assumes any 
responsibility whatsoever for the use of this program and 
associated documentation by others. 


Mandala Media, 
P.O.Box 7082, 


San Diego, Ca. 32187 
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Have you ever had a really great prograw in BASIC and decided 
to take a look inside, only to find the program is unlistable 
??? Or, have you ever intentionally wade a prograw 
unlistable, only to find that you forgot to save a backup 
copy or sowehow lost your listable version ??? 


Well, with the help of SUPER LIST BASIC you can now wake 
those unlistable BASIC prograws listable again. If your 
BASIC prograw resides in a disk file, and will “RUH" when you 
type RUN “D;filenawe", the SUPER LIST BASIC will probably be 
able to list it. 


SUPER LIST BASIC Will restore alwost any BASIC prograw back 
to a listable forw after it has been wade unlistable. If the 
BASIC variables have been clobbered, SUPER LIST BASIC will 
create new listable variable nawes. If the prograw's direct 
line at the end has been chopped off, this will be fixed, and 
the resulting “LISTABLE" prograw way be listed to screen, 
printer, or disk. If listed to disk, the restored prograw 
can even be “ENTERED" frow disk saving you wany valuable 
hours of typing tiwe. 


SUPER LIST BASIC Will also list norwal Clistablel prograws to 
your printer with DOUBLE spacing; a spacing option not 
provided by the BASIC cartridge. 


32K RAM 

ATARI DISK OPERATING SYSTEM CD053 
ATARI BASIC LANGUAGE CARTRIDGE 

ATARI 810 DISK DRIVE COR OTHER ATARI COMPATIBLE DISK DRIME3 

NOTE ! ATARI COMPATIBLE PRINTER IS VERY DESIRABLE CNot 
essential^ 
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1. It is possible to back up the SUPER LIST diskette with any 
standard backup prograw Cnot D0S3, that will copy the whole 
disk. It is reconnended Cnot required}^ that you Make a 
backup before proceeding to step 2 below. 


2. The SUPER LIST diskette does not COMe with liTftRI DOS. You 
Must write a copy of OTARI DOS to the diskette before running 
the prograM. Just load up a standard copy of OTARI DOS, then 
write DOS to the SUPER LIST diskette using the ATARI "H" 
option. This will not harM the SUPER LIST prograM on disk 
which resided in a file not shown when actiuating the DOS 
directory "A" coMMand. 




1. Turn on your disk drive and after the ready light goes 
off, insert the SUPER LIST Cwith D0S5 diskette. 

4. Turn on your video CTU5 screen or Monitor then Power up 
your coMputer. 

5. The prograM will autOMatically RUN. 

■J3X W G_r l-i E 


This is a very easy prograM to use. After following the 
instructions for PREPARING and RUNNING, just follow the 
directions given froM the prograM as follows: 


1. After the title section has coMpleted, you will be asked 
to press the space bar to continue. 


2. After pressing space, the prograM will request the naMe of 
the output device/file. AT this point, you can respond with 
one of three choices. Type S; if you want output directly to 
the screen, type P: for output to printer, or type a file 
naMe such as FILENAME.L5T for output to disk. Output to disk 
is norMally the Most used output. This is because once on 
disk, the file can then be “ENTERED” into the coMputer with 
the BASIC “ENTER” coMMand or even copied to screen or printer 
with the DOS “COPY” coMMand. 
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3. If you choose output to printer CP;3, you will be asked 
whether you want double spacing. If so, type "Y‘* for YES. 
If you do not want double spacing, type “M" for HO. 


4. Next, you will be asked for the nawe of the input file. 
Just type the nawe of the BASIC file on disk that you want to 
list. 


5. SOPER LIST Will now begin to list your program which 
should take approximately 1 to 38 minutes depending on the 
length of the program to be listed. When the listing is 
done, a message will be displayed and you will be asked to 
press space if you want to list another program. If so, 
press space and refer back to step 2 Caboue) in this 
document, 


&. to stop the program, simply turn off the computer. 


7. How if you have listed your program to disk, reboot the 
system with a standard DOS diskette and when you get the 
BASIC READY prompt, insert the diskette containing your new 
“LIST" file. Next, type ENTERED 5FILEHAHE.LST" COf course, 
using the new "LIST” file name in place of FILEHAHE.LST3 Your 
LIST file will be entered into basic, and you may now save 
the BASIC program using a SAUE"D:FILEHAHE.BAS" command. 
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1. If you choose to list to disk, the BASIC file you plan to 
list must be on a diskette that has enough remaining space to 
hold the output "LIST" file. A good rule of thumb is to make 
sure that there is almost double the size of your original 
BASIC file remaining so that you will be sure you will not 
get an error 162 Cfile full3 and be required to start over 
again. In oter words, if your original BASIC program to be 
listed contains 25 sectors on disk, then your diskette should 
have about 58 free sectors remaining. If in doubt, move the 
file to be listed to a new diskette before attempting to list 
it to disk. 


2. As a test to assure that SUPER LIST is working ok, you may 
want to try it out on a short program that you have listed 
previously CYes, SUPER LIST works just as well on listable 
programs as on those that are unlistable3. You can then 
compare the results with your previous listing to assure 
yourself that SUPER LIST is indeed working and does produce a 
complete list file. 
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3. Because SUPER LIST is very thorough and way therefore 
require sowe tiwe to process a long prograw, you way at tiwes 
wonder whether it has stopped processing. If you ever want 
to know whether the prograw is still processing, just hold 
down the "SELECT" key for a few seconds. If everything is 
going as planned, you will hear a chirping sound like a 
little chipwonk working. If you do not hear such a sound 
after holding "SELECT" for approxiwately one winute, you 
should stop the prograw and restart. When listening for the 
chipwonk sound, wake sure your TV or wonitor sound is OH. 


4. When listing to the screen or a printer, the listing can 
be tewporarily stopped by typing "ctl 1". Typing "ctl 1" 
again will restart the action. Be careful not to use "ctl 1" 
when listing to disk as the screen is turned off at tiwes 
during the list and it is then difficult to know whether 
"Ctrl 1" is ON or OFF. If this happens, use the select key. 
If you can hear the chirping sound, then you will know the 
prograw has not been suspended due to a "Ctrl 1" being 
pressed. 


5. With SUPER LIST, you can list your listable BOSIC prograws 
with double spacing; a feature not provided by the BASIC 
cartridge. This is handy when you are developing/analyizing 
a prograw and need extra roow on your listing for writing 
inserted BASIC lines, cowwents, etc. This type listing also 
provides wore space between BASIC operators providing 
iwproved readability. 


6. SUPER LIST analyses and tries to resolve errors detected 
in the prograw you are attewpting to list. If an error 
cannot be resolved, a REH is created which will say "GARBLED 
LINE" followed by the ATASCII nuwbers of the characters SUPER 
LIST is having trouble with. The point here is that whatever 
follows "REM GARBLED LINE" in your output listing should be 
taken for whatever it is worth to you. Garbage lines are 
sowetiwes purposely put into basic prograws to prevent thew 
frow being listed and are not really a weaningful part of the 
prograw. It is up to you to decide whether you want to 
attewpt to reconstruct these garbled lines, or Just discard 
thew. 


7. Sowe BASIC prograws contain wachine language or data 
strings that cause printers to do weird things because sowe 
of the characters in the string are interpreted by the 
printer as control characters. If SUPER LIST detects any of 
these characters while outputting directly to the printer, it 
will substitute a question wark surrounded by parentheses C?3 
in place of the questionable character. When outputting to 
disk, you will get these characters as is, but they will 



still cause problems when you try to list the file to printer 
later. If this should happen to you, you could obtain a 
”LI5TALL‘* type of prograw that will read the "LIST" file, 
then detect and convert those unprintable characters to 
sonething printable and weaningful before printing. HONDALP 
HEDIA is currently considering publishing such a prograw. If 
you are interested, please let us know. 


8. If it is necessary while listing your prograw, for SUPER 
^ LIST BASIC to regenerate listable variable nawes, they will 
be given the generalized nawes 08 through M127 depending upon 
the original order in which they were defined. Strings will 
have a dollar "$** sign appended to the nawe and arrays will 
have a left paren attached. 


S. Just because a prograw has been wade listable is no 
guarantee that the prograw will “RUW”. Though wany of these 
listed prograws will be runnable iwwediately upon being 
entered, there are wany reasons why others will not “RUN**. 

For exawple, sowe prograws in order to run correctly, wust 
have their variables entered in the sawe order as when they 
were originally created, and when you *‘ENTER“ a listed 
prograw, there is no guarantee that this will happen. 
Sowetiwes Basic prograws that use wachine language 
subroutines depend upon initialization or loading of prograws 
and data prior to the execution of the BASIC prograw and so 
forth. There is a long list of reasons why a prograw that is 
listable way not “RUN**. HANDALA HEDIA does not take 
responsibility for providing you with a “RUNNABLE** prograw. 

It is your responsibility to wake a LISTED prograw *‘RUN**, if 
that is what you want it to do. 


10. SUPER LIST BASIC Will not list HANDALA HEDIA prograws 
that have been protected against listing CFor exawple, SUPER 
LIST will not list itself}. NO apologies, if you really want 
it, we will sell you a cowwented listable, runnable version 
of SUPER LIST BASIC for a were $ 50 . 00 . 


11. At the present tiwe, we believe that SUPER LIST BASIC 
will list any «*RUNNABLE‘* ATARI BASIC file With the exception 
of HANDALA HEDIA prograws. This way or way not hold true in 
the future. If you find any exceptions to this, please let 
us hear frow you. 


12. The overriding purpose of SUPER LIST BASIC is educational 
in nature. Your education in BASIC prograwwing can be 
greatly enhanced through the discriwinate use of this 
prograw. Use it wisely, and only for purposes that are 
legal . 
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